Creating and Deleting Draw Contexts23

QuickDraw 3D RAVE provides routines that you can use to create and delete draw contexts.

QADrawContextNew

You can use the QADrawContextNew function to create a new draw context.



 
TQAError QADrawContextNew (

                     const TQADevice *device, 

                     const TQARect *rect, 

                     const TQAClip *clip, 

                     const TQAEngine *engine, 

                     unsigned long flags, 

                     TQADrawContext **newDrawContext);

device: A device.
rect: The rectangular region (specified in device coordinates) of the specified device that can be drawn into by the drawing engine associated with the new draw context.
clip: The two-dimensional clipping region for the new draw context, or NULL if no clipping is desired. This parameter must be set to NULL for devices of type kQADeviceMemory .
engine: A drawing engine.
flags: A set of bit flags specifying features of the new draw context. See "Draw Context Flags Masks" for complete information.
newDrawContext: On entry, the address of a pointer variable. On exit, that variable points to a new draw context. If a new draw context cannot be created, *newDrawContext is set to the value NULL .

DESCRIPTION

The QADrawContextNew function returns, through the newDrawContext parameter, a new draw context associated with the device specified by the device parameter and the drawing engine specified by the engine parameter.

QADrawContextDelete

You can use the QADrawContextDelete function to delete a draw context.



 
void QADrawContextDelete (TQADrawContext *drawContext);

drawContext: A draw context.

DESCRIPTION

The QADrawContextDelete function deletes the draw context specified by the drawContext parameter. Any memory and other resources associated with that draw context are released.